PDK_ State Bits for Pen Driver Kit

The PDK_ values inform the system when a mouse event is being generated by pen movement, as well as the current state of any barrel buttons. This information is contained in the wPDK and wPdk members of the STROKEINFO1AOCY9 and PENPACKET1AOCX. structures, respectively. The GetPenAsyncState1AOBX. function also accepts a PDK_ value as its only argument. The following table lists the PDK_ values:

Constant

Value

Description

PDK_NULL

0x0000

No flags set (default).

PDK_UP

0x0000

Same as PDK_NULL.

PDK_BARREL1

0x0002

Barrel button 1 is depressed.

PDK_BARREL2

0x0004

Barrel button 2 is depressed.

PDK_BARREL3

0x0008

Barrel button 3 is depressed.

PDK_DOWN

0x0001

Pen is in contact with the tablet.

PDK_SWITCHES

0x000F

All of the above.

PDK_TIPMASK

0x0001

Mask for testing PDK_DOWN.

PDK_TRANSITION

0x0010

Only has meaning if set by pen services. This bit is set if the first point in the sequence being returned is in a different pen-tip state (up or down) from the previous points returned.

If set on a call to AddPointsPenData232HACD, a new stroke is created even if the previous call to AddPointsPenData232HACD appended points of the same pen state. By default, a sub-sequent call to AddPointsPenData232HACD adding points of the same state as the previous call appends the points to the last stroke instead of creating a new stroke.

PDK_EVENT

0x0010

Alias for PDK_TRANSITION.

PDK_PENIDMASK

0x0F00

Mask for bits 8-11 (see paragraph following table).

PDK_INVERTED

0x0080

Pen is upside down ( eraser  end is in contact with tablet).

PDK_INKSTOPPED

0x2000

Inking has stopped.

PDK_OUTOFRANGE

0x4000

Set if the tablet detects the pen leaving the range of detection. If set, other information in the packet is invalid.

PDK_DRIVER

0x8000

Set if event is generated by the pen driver (as opposed to the mouse driver).

 

For PDK_ values other than PDK_PENIDMASK, bits 8 through 11 contain the identification number of the physical pen that generated the event. Pen numbering begins at 0.

See Also

PENPACKET, STROKEINFO